The Atari Compendium

home *** CD-ROM | disk | FTP | other *** search

/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / editors / 7up_engl.lzh / 7UP_DOCU / 7UP_ENGL.DOC next >

Wrap

Text File | 1993-04-19 | 61.0 KB | 1,491 lines

The Manual for 7777777 7 7 7 U U PPPP 7 U U P P 7 UUUU PPPP 7 P 7 P -------------------- Version 2.09d 14.07.92 Table of contents Page ------------------------------------ 0. Product description 3 1. System requirements 4 1.1. Installation 4 1.2. Operation under Gemini* 5 1.3. Operation under MultiGEM* 5 2. The Dropdown Menus 5 2.1. Configuration save 13 3. The Keyboard 13 3.1. The Function keys 15 3.2. The SHIFT key 15 4. Block operations 16 4.1. Column setting 16 4.2. Numeric Operations 16 5. Search and Replace 17 6. The Print menus 21 7. The Desktop icons 23 8. The GEM-Window 24 8.1. The Dialog boxes 24 9. The Clipboard 24 10. Technical Details 25 11. The TURBO-C HELP Accessory 29 12. Trips and Ticks 30 13. Four Words 30 14. Greetings 30 0. Product description ---------------------- 7UP is a GEM*Text editor for the Atari ST. 7UP uses the Advantages of this Shell, such as Dropdown Menus, GEM-Window, Dialog boxes and Desktop icons. For Operation under MultiGEM can 7UP also without Desktop icons working become. See Chapter 1.3 and 2.1. 7UP can both with the Mouse as also by Keyboard commands be controlled and has been, as far as as possible, according to Proper programming lines developed. 7UP makes use of no exotic formats, no getting used to poor Features, so that everything immediately with it is clear. One Strength of 7UP is its high Speed and the Possibility of Column processing. With it can one comfortably edit and calculate Numeric tables(!), which with other Editors normally is not possible (see Chapter 4). Moreover 7UP provides by efficient Functions Searching for Text passages, GREP and Match, programmable Function keys, loadable GDOS-Fonts, a Text preview function and convenient Printing. With its Shell function can It with the Management system communicate. With 7UP as many as 7 Texts, with up to 512 Characters per Line, "simultaneously" can be edited (thus the Name 7UP). 7UP is a Shareware program. Therefore you are asked to pay the Author an appropriate Amount, when You with 7UP are pleased, and its regular use want. When you no Pirate copy use want and in Further development of 7UP are interested, use please this opportunity and invest this Amount, so that in the Future inexpensive Software you can continue to receive . Otherwise is the further development of 7UP undermined, by the amount of that Pirate copy. The Cost for the Version 2.00 of 7UP is as follows: Atari ST/STe/TT : 50.- DM Shareware is not cost-free! 7UP is available by your Sending a 720 kilobyte formatted 3.5" Disk and a stamped and addressed Return envelope to the following Address: Address: Michael Thänitz Osningstr. 69 4800 Bielefeld 1 Germany (Deutschland) Account-number: SSK Bielefeld BLZ 480 501 61 KNR 64573009 E-Mail: MAUS-Net Michael Thänitz @ BI Quark Bielefeld USERNAME: MICHAEL THÄNITZ TEL. 0521/24222 (PEP) When you Ask about 7UP, mention please always the Version-number. You find it at the Beginning of the Users manual or in the Copyright menu. Forget please not, Your Address on the transfer form to note, with it you as user registered become can. Your copy is subject to Data protection and cannot be given away to a third party. It is expressly desired that 7UP be distributed, only in complete, unchanged Form. On the Disk or in the Archive must the following Files be: 7UP.APP 7UP Main program 7UP.Rsc Resource file for 7UP 7UPICN.Rsc Icon file for Gemini* NEWICONS.Rsc Icon file for Gemini* from René T. Fritz 7UP.DOC Users manual (what you are now reading) LINKS.LAY Layout for the left Page of this DOKU (12 CPI) RECHTS.LAY Layout for the right Page of this DOKU (12 CPI) TAXPATCH.TTP Patch program for the Value Added Tax TAXPATCH.DOC Users manual for TAXPATCH CALCLOCK.ACC Printer spooler compatible with PC-GEM/3 CALCLOCK CALCLOCK.INF INF-File with it CALCLOCK.DOC Users manual for CALCLOCK SPOOL.TTP MUPFEL-Command for Gemini*-Desktop SPOOL.C Source for SPOOL.TTP SPOOL.MAN Online-Manual for MUPFEL CHANGES.TXT News Uploading to Bulletin board systems is express desired. Please recommend 7UP further, when with it you are pleased. When not, well yes... It is express forbidden, 7UP at expense in the PD-Version to sell. Generally can be said, that from Third parties no Charge in any Way for 7UP can be made. For your handling can a charge be rightly pursued. 7UP has been according to my best abilities developed and tested. Not-withstanding could it to Errors come. The Author assumes none whatsoever Liability for Damage in any way, direct or indirect arising from the use of 7UP. It can also not guaranteed be, that 7UP for any certain Purpose fit is. Should you Error find, then delete please, if possible, all AUTO folder programs and Desk accessories. If the Error now always remains reproducible, inform me please. You can easily notify by per E-Mail. Suggestions for improvemenent are just as welcome. 1. System requirements ---------------------- For Operation of 7UP is an Atari ST Computer with Disk drive, TOS in ROM and at least 512Kbyte RAM necessary. Each further Expansion level such as Hard-disk or more RAM increases your Convenience. 7UP should also on the Mega STe and TT run perfectly. Just as are also Big screens with Color display supported. Problems could it display with large Dialog boxes in lowest Monitor-resolution (320X200). 1.1 Installation ---------------- Copy the Files from the Disk in(to) a Folder of Your Choice. The Accessory CALCLOCK.ACC and CALCLOCK.INF copy in(to) the Root- folder of the Boot partition of Your Hard-disk. When you only a Floppy- disk drive possess, copy the ACC to your Boot disk. For the Keyboard setup via Control Panel I recommend the following Value: Delay 200MS, Repeat rate 20MS. 1.2. Operation under Gemini* -------------------------- When you use the Desktop Gemini*, placed in the File 7UPICN.RSC is an Icon for 7UP to Use. As that Icon is in(to) Gemini* integrated, please see the Users manual for Gemini*. SPOOL.TTP copy It in(to) the Folder \GDIST1_2\BIN\, SPOOL.MAN in(to) the Folder \GDIST1_2\MAN\ (Only Gemini* from Version 1.2). 1.3. Operation under MultiGEM* ---------------------------- As already mentioned, it runs well on one new TOS-Version, PAM-MultiGEM, a Way Multitasking is allowed. Multitasking means: 1. Start several Application programs. they run then like parallel. 2. Switch from one Program to another by Mouse click in the Window. The Menu bar becomes automatically switched. 3. Desktop background is usable, so that the Communication with the Management system further on possible is, e.G. Files copy. Requirement: 1. GEM-Program should not its own Desktop have, or it should switch off be. 2. Clean Programming and compatible GEM-Binding (of) the Program. Switch off the Desktop: Under "Work save" can you select, whether the Desktop is shown or not. See Chapter 2.1. 2. The Dropdown Menus -------------------- During the Description of 7UP it is assumed, that you have 7UP at hand and are conversant in the use of GEM-Programs. The Use of the Mouse, Dropdown Menus, Windows, Dialog boxes and Icons, as well as their Manipulation, should be familiar. 7UP provides seven Dropdown Menus in(to) which all Commands for the Control (of) the Program are contained. The Menus appear as follows: 7UP File Edit Search Compute Mode Window Options |-----|-------|------------|--------|---------|-------|---------|--------- | about 7UP... ◆A | -------------------- | New layout ^N | | open... ^O | | Merge... ^R | | Information... ^I | |----------------------| | Close Doc ^U | | Save ^S | | Save as... ^M | | Abort ^D | |----------------------| | Call shell... ^E | |----------------------| | Page layout... ◆L | | Print... ^P | |----------------------| | Quit ^Q | ---------------------- | Undo UNDO | |---------------------| | Select All ^A | |---------------------| | Cut ^X | | Copy text ^C | | Paste text ^V | |---------------------| | Left justify ^K | | Right justify ^J | |---------------------| | Upper/lower case | | All upper | | All lower | | Capitalization | |---------------------| | GEM-Clipboard ◆G | --------------------- | Search/Replace... ^F | | Continue search ^G | |-----------------------| | Go to Block start ^G | | Go to Block end ^E | |-----------------------| | Set mark... | | go to Mark... | |-----------------------| | go to Line... ^L | ----------------------- | Column block ◆C | |--------------------| | Number ◆N | | Sum ◆S | | Average ◆M | | Std.deviation ◆D | | Value Added Tax ◆W | |--------------------| | Calculate all | -------------------- | Set tabs ◆T | | Line length... ◆U | | Set block ◆G | | Insert mode INSERT | | Word wrap ◆I | --------------------- | Next Window ^W | |----------------------| | ...over and under | | ...side by side | | ...stacked | ---------------------- | Choose fonts... ◆F | | Character set... ◆E | |---------------------| | auto. indent | | Function keys... | | Text preview... ◆V | |---------------------| | Save settings ... | --------------------- Note: After a number of the Menu entries are shown Letter combinations - The so called Keyboard shortcuts. See Chapter 3. Menu: 7UP Here are shown theDesk accessories, naturally all freely accessible. Menu selection: about 7UP... ◆A Here you find the Copyright notice, as well as the Version number. When you Ask me a question about 7UP, please always mention the Version-number. Under "Info" is shown a Short data block about 7UP. Menu: File Under this Menu you find all Commands for the Loading, Saving and Printing of the Text, as well as for Quitting the Program. Menu selection: New layout ^N For a new Text give to open, select this Menu selection. It opens a Window as well as an Icon using the Name "Untitled.TXT". When you later want to save this new Text, assign in the FSB (File selection box) to the File any valid name you may choose. Menu selection: open... ^O Enables loading of an already existing Textfile from Disk. It also produces a new Desktop icon. Select with the FSB the Textfile that you wish to load. When you while loading press the SHIFT key, the Atari 'ß' changes in(to) an IBM*-compatible 'ß'. You have then less Problem with printing this Character. This works also for the "Merge...", as well as for "Paste text" in the Edit-Menu. See also Chapter 3.2. Menu selection: Merge... ^R Places a File, that you select with the FSB, at the current Cursor position. Menu selection: Information... ^I Gives Information about the File or the marked Block in the active Window. The following Information is presented: 1. Filename (editable) 2. File size 3. Number of lines 4. Number of pages (dependent on Page layout) 5. Number of loaded Files 6. free Working memory When you have one or more Icons selected, you receive the appropriate Information about that Icon. The affected Icon blinks immediately before its information is displayed. Menu selection: Close doc ^U Closes the open Window for its Icon. If the File has been changed, a dialog asking if you want to save the changes will appear, so there is no chance you will accidentally lose your work. Menu selection: Save ^S Saves the File under the Window name. Spaces at the End of the Line are automatically suppressed. When you hold down the SHIFT key, the text is appended to the existing file! The Text can by Tabs become compressed (see "Tabs..."). Save only works if since the last Save changes in the Text have been made. The Functions of the SHIFT key are in Chapter 3.2 explained. Menu selection: Save as... ^M Gives You before the Save the Opportunity to, in the File selection box, give a new Name to the file being saved. The new Name then also applies to the open window. If the filename already exists, a Warning alert results. When a Block is marked, only the Block is saved under the new Name. When you during this Action press the SHIFT key, the File (the Block) onto the already existing File will be appended! Also here appears an appropriate Display. See Chapter 3.2. Menu selection: Abort ^D The Text becomes overloaded, i.e. it is deleted and from Disk reloaded. You nevertheless are given a chance by alert box to save changes before the delete/reload. The Function recommends itself, when you want to abandon all current changes. When no one changes have been made, nothing happens when you choose this selection. Menu selection: Call shell... ^Z When you from 7UP a Desktop shell want to run, if the Shell pointer is supported, can you from here issue Commands to the Management system. e.g. Gemini*. When no Shell pointer is supported, e.g. original Atari Desktop, an appropriate Error report results. In the Help box can you these Facts of the case read. With the Button "Program start" can an external Program using the File selection box (FSB) directly be called. As Parameter uses that which in the Command-line is placed, or that, which you with the FSB with the title "Start program" select. When you need no Parameter, so delete the Command-line by ESC or click Abort on "Parameter assign". Menu selection: Page layout... ◆L Menu selection: Print... ^P Page layout and Printer setup. To Print a marked Block no dialog box appears, because no Layout settings are necessary. Holding the SHIFT key sends a Formfeed after printing. See Chapter 6, 3.2 and 12. Menu selection: Quit ^Q End the Program. Changed Files can still be saved. When you hold the SHIFT key while quitting, the last Configuration is saved. See Chapter 2.1 and 3.2. Menu:Edit Under this Menu you find all Commands for the Textblock handling. Menu selection: Undo UNDO Following Operations can with Undo be canceled: 1. open File 2. Cut Block (only with the Clipboard) 3. Delete Line " 4. delete up to Line end " 5. Delete Word (Double click) " 6. Editing a Line Undo functions not, when its Menu entry is grayed (Disabled). You can also operate these Menu selections by the UNDO key. See Chapter 3. Menu selection: Select all ^A Marks the whole Text or, when no Window is open, all Icons, provided that 7UP is installed with its Desktop. The latter is helpful if you want to delete all Icons at once. See Chapter 1.3. Menu selection: Cut ^X Cut the marked Block, deletes It from the Text. The Block is however not lost, but remains in the buffer. See Chapter 4. Menu selection: Copy text ^C Copies the marked Block in(to) the buffer. It can then be inserted anywhere, and as many times, as you wish. The block marking is lost in this operation. Menu selection: Paste text ^V Places the cut or copied Block on the current Cursor-position. The Insertion can be multiply repeated. The Block naturally can even be pasted into another Window. Menu selection: Left justify ^J Menu selection: Right justify ^K Shifts a marked Block by one Tabstop to the left or to the right. The block Marking is not lost. The Process can be multiply repeated. When the Column block is activated, you can even shift Text columns. Menu selection: Upper/lower case Menu selection: All upper Menu selection: All lower Menu selection: Capitalize Converts letters in the marked Block. Capitalize means to change the first Letter of each Word to a Capital letter. By this selection actual Words, and not just strings separated by Spaces, are found and capitalized. Menu selection: GEM-Clipboard ◆G All Block operations work using the GEM-Clipboard. Default has this Option switched-on. See also Chapter 9. Menu: Search Under this Menu are all Commands for Search and Replace. Menu selection: Search/Replace... ^F Here you can search and replace Character strings in Your Text. The Search text as well as the Configuration of the Buttons can be saved. See Chapter 5. Menu selection: Continue search ^G Enables you to again Search or Replace, when not by Replace the Button "all" chosen has been (in that Case naturally all Text passages will have already been replaced). See Chapter 5. Menu selection: Go to Block start Menu selection: Go to Block end When a Block is marked, can you hereby to Block start or Block end jump. The Cursor always positions itself at the beginning of the Line. Menu selection: Set mark Internally Marks the Text passage, where the Cursor is located. Up to five Marks can be set. Menu selection: Go to Mark Jump to the Place, where the last marked Text passage is. There can be up to five user-set Mark that can be jumped to. Menu selection: go to Line... ^L Shows the current Line number where the cursor is located. Change the Number to the desired Line. The Cursor then jumps to the appropriate Line. Menu: Compute With the Help of this Function it is possible to do simple Calculation. Menu selection: Column block ◆C Switches between normal Block marking and the Column block marking. Column blocks are e.g. self-contained Numbers-columns that conveniently can be copied to another Place. This is not possible with normal Block marking. Default is this Option active. See also Chapter 4. Menu selection: Number ◆N Sum ◆S Average ◆M Std.deviation ◆D Value Added Tax ◆W Calculate all Numeric Operations with Column blocks. To sue these functions the column block must be activated. See Chapter 4.2. The Value Added Tax was at the Time set at 14.00%. When it changes you must use the supplemental Program TAXPATCH.TTP. Even if you don't want to change it, you'll have to when the Federal government decides IT wants to change it. :-) <translator's note: the VAT function may have seemed useless to American users, but if Mr. Clinton has his way... You can use TAXPATCH.TTP to reset this function to your state sales tax percentage, standard markup, or whatever you find useful> Menu: Mode Here are setup choices that influence the operation of the editor. Menu selection: Tabs... ◆T Enables Configuration (of) the Tabs, separately for each Window. The Tab stop becomes highlighted in the Info line of the Window. By the Button "compress" you can choose to save the document in compressed tab form. By pressing the TAB key the cursor is moved to the next Tab-position placed. With BackTAB (SHIFT TAB) it becomes Tab position back positioned. Menu selection: Line length... ◆U For text lines to constantly flow one after the other with consistent margins without your using the RETURN key as on a typewriter, here can the automatic Line wraparound for the desired Column width be installed. You need then to give no more Consideration of the Line length. Type Your Text without worry about pressing RETURN. The Formatting result is automatic. Default is this Option active. Menu selection: Set block ◆B This is a Complement of the Line wraparound. An unbroken Line becomes automatic in the Length being dragged. over several Line considered, receive you like this a left and right-justified arranged Text. 7UP drags Lines with Words not considered separately, but places a maximum of two Spaces between the individual Words. It can so occur, that the Block mark is not always one hundred percent reached. Default is this Option active. Menu selection: Insert mode INSERT Switches between Insert and overwrite mode. Default is this Option switched-on. See Chapter 3. Menu selection: auto. Indent ◆I Enables the Cursor by Pressing the RETURN-Key to be positioned under the first Letters of the previous Line. This Option is intended for Programmers. Default is this Option switched-on. Menu: Window Menu selection: Next Window ^W Makes possible Switching among various Windows. Alternatives: 1. Double click on the appropriate Window Icon 2. Selection (of) the Icons and Operation (of) the Menu selection "open..." 3. Use the Shortcut '^W' Menu selection: ...over and under Menu selection: ...side by side Menu selection: ...overlapped Orders several open Windows as you wish them displayed. Menu: Options Here you find a series of additional Configurations, that mainly serve to make 7UP more convenient to use. Menu selection: Font choice... ◆F In the Font choice box the following information is presented: 1. Font name (only nonproportional Fonts) 2. Point size (of) the setup Fonts 3. Text color 4. Background color 5. Style sample in the small Window To use GDOS-Fonts, (AMC)GDOS must be booted in the AUTO folder. See Chapter 10.3. The Selection of the nonproportional Character sets is automatic. Usage is similar to that of the File selection box. A maximum of 16 Fonts with a maximum of 16 different Point sizes can be loaded. That should in Practice be enough. E.E. there also are not more Fonts available. Be sure that both Font type and Point size are selected, when you press the OK-Button, else no new Font becomes installed. You will note that some Fonts have Long names. Those names you can see by using the horizontal Scrollbar. If the installed Management system permits, you can in the editable FSM-Field also configure other In-between sizes. 7UP supports 16 Colors for the color Representation in the Text window. You can assign different Colors to the Text or the Background. You achieve the Color switching by Adjusting the little Scroll arrow beside the Colors box. There is placed 'F' for Font color and 'H' for Background color. The Button "Standard" places the Colour again to black/white. The Color setting can be saved, if you wish. The Help box provides information about the Installation of GDOS. See also Chapter 2.1 and 10. Menu selection: Character set... ◆E Makes a Dialog box displaying the complete Character set appear. Here you can by Mouse-clicking on the desired Character, which is not accessable from the Keyboard, insert that character at the current Cursor position. The inserted character will be of the font current selected by the font choice box. The following characters are not available: 1. Null byte ($00) 2. Linefeed ($0A) 3. Carriage return ($0D) As an Alternative you have, as under MSDOS, the Possibility to user-assign the Key code with the Help of the ALTERNATE key. Press the ALTERNATE key and give simultaneously the Decimal value (of) the desired Character. The Decimal value can be found in any ASCII-Table. Menu selection: auto. Backup ◆B Produces a Backup file with the Extension 'BAK', when you save a file. The old File is retained with the extension 'BAK'. Default is this Option switched-on. Menu selection: Function keys... Controls usage of the Function keys for Text macros. The Text can be saved. When on the chosen function key no one Macro exists, then appears the Dialog box for the Function keys, and you can assign a new Macro. When you have Marked a word, it becomes assigned to the Function key that you then press, but only if that function key was currently unassigned. The automatic Usage result by Pressing the Function key. The Help box shows the Variables that you can use in your macros. See also Chapter 3.1. Menu selection: Text preview... ◆V The Text becomes in accordance with the "Page layout" displayed in little Windows. Here can you beforehand see, how your printed pages will appear. If you directly insert formfeeds (FF) into the text, be sure that the formfeed is the only character in the line! Otherwise you will confuse the layout. You can interrupt the output by pressing the left mouse button. When you want to look at an already formatted file, you should set the top and bottom margins and the header and footer lines to zero if you don't want them to appear. When you have a block marked, Text Preview displays only the block. Menu selection: Save settings See Chapter 2.1. 2.1. Save settings ------------------ There are two ways to Save the Configuration. 1. Operation (of) the Menu selection "Save settings" 2. Press the SHIFT key while quitting the Program Following settings are saved: 1. current Window position 2. Icon position 3. Tabs (for each Window) 4. Configuration of the Menu choices 5. Configurations in the Dialog boxes 6. Default font and Color 7. The Names of the last edited Files (only by Quitting...) 8. Cursor position in the Text When you want the Desktop turned off for Operation under MultiGEM, you must answer the Question "Desktop turned off?" with "OK". 3. The Keyboard --------------- You are already aware, that after the Commands in most of the Dropdown Menus are shown Characters such as ^X, or ◆G. These are the so-called Keyboard shortcuts for the appropriate Commands. ^X means Press and Press and hold the CONTROL-Key as well as the Letter 'X'. It is there all the same, whether 'x' or 'X'. The Character '◆' is shown for the ALTERNATE-Key, the Procedure is the same as with CONTROL. When you operate these Key-combinations, it acts the same as a Mouse click on these Menu entries. So you can control most of the menu entries by the use of keyboard shortcuts. CAPSLOCK switches on Capital letters. The Status becomes by 'CAPS' in the Info line (of) the active Window highlighted. INSERT switches between Insert and overwrite mode. CONTROL-Cursor (left or right) moves the Cursor from one Word to other. This uses not only Spaces as word Separators, but also Special characters. SHIFT-Cursor (left or right) left jumps the cursor to the beginning of the line, right to the end. BACKSPACE deletes the Character to the left of the Cursor and pulls the Remainder of the Line back accordingly. DELETE deletes the Character to the right of the Cursor and pulls the Remainder the Line accordingly. SHIFT-DELETE deletes the Word under the Cursor. Alt-DELETE deletes from the Cursor position up to the Line end. CONTROL-Y deletes the Line, in which the Cursor is placed. When the Clipboard is activated the Line becomes recorded there. TAB places in the Insert mode <Tab stop> Space and pushes the Line to the right. In the overwrite mode becomes just the Cursor to the right positioned. SHIFT-TAB set the Cursor one Tab position backward (to the left). Cursor-key Moves the cursor in the direction indicated by the arrow key. Also hold down the SHIFT key, becomes the Screen page display scrolled. You can position the Cursor also with the Mouse, by pressing the left mouse button on the point where you want the text cursor to be. HOME go to the Beginning (of) the Text. CLR (SHIFT-HOME) go to the End of the text. SHIFT-Cursor-UP scrolls page display up. SHIFT-Cursor-DOWN scrolls page display down. UNDO forces the Block operations "Cut" as well as Delete line with CONTROL-Y to be canceled, assuming that the Clipboard is active. Just the same can a single Line again be restored, assuming, that the Cursor is located in the appropriate Line. With this must the Clipboard not be active. ESC has no one Function, except in Dialog boxes in the GEM-customary Manner. 3.1. The Function keys ------------------------ The Function keys can with Macros be 'loaded', the macros can then of course be inserted into the text as you wish. 7UP recognizes the following Variables: %H = Hour %M = Minute %S = Second %T = Day %M = Month %J = Year (2 digits) %W = Weekday (Sunday, Monday, ...) %D = Day of the Year %F = complete Pathname of the current File %F = Name of the current File Example: Bielefeld the %T.%M.19%J at %H:%M (o')clock produces: Bielefeld the 15.05.1991 at 12:45 (o')clock You can assign 20 function key macros, 10 unshifted and 10 shifted. The toggle button 'shifted'/'unshifted' in the function key dialog controls which way the macro is registered. As an additional aid, an upward pointing shift arrow appears in the dialog before the function key designation for each shifted macro. If the function key you press is unassigned, the dialog box will appear and you may assign a macro. If it is assigned, that macro will appear in your text at the cursor position. The Help selection of the dialog box shows you the available variables to be used in your macros. The Percent sign itself must be typed in as %% (double percent sign)! Your macro entries can of course be saved if you wish. See Chapter 2.1. 3.2. The SHIFT key ------------------- The SHIFT key has a special Meaning in many of 7UP's Functions. Here is a listing of the SHIFT key's effect on those functions: Function Effect -------------------------------------------------------------------------- "open..." Change Atari 'ß' in(to) IBM 'ß' "Merge..." " " " "Save" Appends the Text to the existing File "Save as..." " " " " "Print..." When a block is marked, on Print completion there is a Formfeed sent to the printer (Single sheet entry) "Quit" Stores the last System settings "Cut" Appends the Text on(to) the existing Clipboard file "Copy text" " " " " "Insert" Change Atari 'ß' in(to) IBM 'ß' Single click Mark beginning (and end) of a block Double click Marks entire Text line in the Window CONTROL-Y Appends the Line onto the existing Clipboard file Not with RAM-Clipboard! Clicking on Icon Make Selection of several Desktop icons Dialog box ("handle") Make Dialog box become transparent Dialog box centering Centers Dialog boxes 4. Block operations ------------------- A Text block can in various ways be marked: 1. Overstroking (of) the Texts with the Mouse, while pressing the Mouse button. The Window scrolls automatically when you exceed the Window limits 2. Cursor positioning with the Mouse, while pressing the SHIFT key 3. Double click with the Mouse (Word marking) Automatically selecting in "Search/Replace" or "Function keys..." 4. Double click with«by the Mouse, while pressing SHIFT key (Line marking) Now can the familiar Cut-, Copy- and Paste functions take place. By "Information" (^I) you can see the Size (of) the marked Block in number of letters, lines and pages. A cut or copied Block remains in the Buffer until you replace it with a new Block operation. For instance, the Block in the buffer can always again be inserted. When a Block is marked, it is immediately replaced by the newly selected one assuming that the Cursor is still located within the Blocks. The Column block mode is not in the Position to generate new lines. When you so on the End of text Column blocks want to add lines, you must before(hand) once or several times press the RETURN key. 4.1. The Column setting -------------------- Sometimes it happens that Activate the Column- you want multiple columns block and mark the in your text (the way that second Column as a Newspapers usually are. Block. Copy It in(to) Write the text Columns the Clipboard. Position first of all with e.g. a the Cursor at the line length of 27. With appropriate Place Help of the Column blocks beside the first Column copy the second Column and and place the Block from place it beside the first. the Clipboard again. This way you can even make three columns if you wish. This Procedure is by using the Column block right simple and fast to do. 4.2. Numeric Operations --------------------------- In Connection with the Column block is it possible, to do simple Calculating. Procedure: 1. Switch to the Column block mode 2. Mark a Number column 3. Operate one of the Mathematical menu selections The Outcome becomes in a Box highlighted as well as copied into the Clipboard and can by "Insert" be copied in(to) the Text. The result is shown to two Decimal places, because the calculation method is based on the normal money calculations. Mathematical Action of the Calculation methods: 1. average n _ 1 -- x = - \ x n / i -- i=1 2. Standard deviation n 1 -- _ s = --- \ (x - x) n-1 / i -- i=1 Note: It is possible, that 7UP here can deliver faulty Results, when gaps exist in the marked Column. e.g.: Numbers: 1.0 2.0 3.0 4.0 5.0 ---------------- Number: 5 Sum: 15.00 Average : 3.00 Correct Outcome Numbers: 1.0 2.0 <- Here a Number is missing! 4.0 5.0 ---------------- Number: 5 <- 4 Sum: 12.00 Average : 2.40 <- 3: False Outcome The Column of numbers should be uninterrupted. 7UP is not a normal Calculation program. For the Results display the internationally used decimal point is shown. 5. Search and Replace ---------------------- A special Strength of 7UP is its Search and Replace of Text passages. 7UP provides efficient Functions from the Unix*-World. Exact descriptions of these functions are given below. Open the"Search/Replace..." dialog from the menu (or by ^F). In the first of the two Input fields type in the String to be found. In the second field you may type in a replacement string if needed. Which Search mode used is determined by which of the round radio buttons you choose to activate. The square checkoff boxes (if not disabled for the operation you have chosen) provide other important search criteria choices. If boxes are disabled (not pertinent to the current operation), they will show as 'grayed out' or faint. When a Block is marked, so interprets 7UP, whether a search-ender expression is marked, or whether in the Block itself marks the search range. If the Block is several Lines long, it is interpreted as the Search range. If it is only one Word or at most one Line, so must it the to search end expression be. You can see by the way the small boxes are already marked when you open the dialog. 7UP provides three Search modes: 5.1. The GREP-Function (Get Regular ExPression). GREP seeks a Pattern in the Text, the exact Composition of which is not known. You want For example to find all Words in the Text, that instead of with the Umlaut 'ü', are written with "ue". (German) words like "Quelle" or "Aktuell" for instance are not written with "ü", and if you don't want to find them, you can use as the Search pattern "[^Q]ue[^l]" (do not use the Quotation marks, as they are only used in this text to distinguish what you must type in). "ue" is placed there for the Umlaut substitute, and the angular Brackets contain the Letters whose Finding should be avoided. It means this: search for all "ue" not preceded by "Q" and followed by 'l'. '^' indicates that the Character following it is not to be found. No Distinction is made between Large- and Small-letters. If you wish to find all "ue" that are not umlaut substitutions, use "[Q]ue[l]" to specifically search for "Quelle" or "Aktuell". Because here now there is no '^' within the Bracket, you are Including the bracketed letters in your search instead of excluding them. There gives it basically the Problem, that you must know exactly which Words the search pattern will find and which it will not. Using this Pattern a Word like "Suelze" falls through the Net, even though an 'l' does come after "ue". We must therefore expand the Search pattern. We search now all "ue" without 'Q' before it and without 'l' after, but after 'l' allows a 'z' to be. Search for "ue[l][^l]" and hope that "Suelze" now is found. A second Example: You may in Your Text want to find all '/', where a Digit precedes, and then a Letter follows it. e.g. to find "22/BR" but not "138/0.5". The Search pattern is then "[0-9]/[a-z]". Before the '/' are only Digits, behind the '/' only Letters are allowed. As an alternate pattern you may use ":d/:a". For explanation see below A third Example: You want to find all words that begin with one digit, Like the word "7UP". Here a preceding space is expected, so the search pattern is ": [0-9]". Fourth Example: You want to find all punctuation that comes at the end of a line. e.g. Line ending with '.'. Type in "\.$". Consider that the '.' is a Special character and must be in quotes. The '$'-Character is used for the Line end, and must naturally also be at the End (of) the regular expression. When you want to find all Punctuation at the Line end, type in "[,;.:!?]$". (This is actually not a Comic-Chimpanzee-word!) Note: The Quotation marks before and after the Examples just serve to distinguish the examples within this Documentation. The Regular expression describes the Pattern to search for. It makes no Distinction between Large and Small text. The Search possibilities correspond with the technical Base and not the full Extended perfomance (of) the Unix*-Program GREP. Here is a List of those Special characters, that with the precise Wording use as Search criteria is possible: '.' The period is placed for a desired Character. '^' The Caret is placed for the Line start (implemented, but not functioning; must however be quoted. see below). '$' The Dollar sign is placed for the Line end. '\' The Backslash quoted each Characters. For the '.'-Characters self represent to can, write "\."; just as "\\", "\^", "\$". Special characters must basically quoted become. The Colon describes the Class (of) the search ender Characters. ':a' is placed for an alphabetic Characters, ':d' for a Digit, ':n' for an alphanumeric Characters, ':.' for Punctuation, ': ' for Space. '*' When a Character is followed by a '*', that means that the last Character entered is allowed any number of repeats. "fo*" finds "f", "fo", "foo", "fooo" etc. '+' As '*', however must the last Character at least once appear. "fo*" finds "fo", "foo", "fooo" etc. '[]' Character set. A Character string in(to) angular Brackets is placed for exactly these Characters, but no other. When the first Character is a '^' these Characters are excluded from the Search. e.g.: "[XYZ]" is placed for "XX" and "ZYX", during "[^XYZ]" indeed "ABC" is not but "AXB" is found. A Character string range can by '-' specified become. Take note of It please, that [a-z] will find all alphabetical Characters, but [z-a] in general no alphabetic Characters will find. Digits become by [0-9] specified. There are also Limitations possible, e.g. [7-9] (so only 7,8,9). The same holds true for Letters, e.g. [m-e] or [^a-bd-z?] seek only the Letter 'C', all Digits, as well as Special characters except '?'. The Sequence of the Characters in the Bracket plays no Role. In the Help box you can review these Special characters and their Meanings. Note: The Special characters are not separately interpreted within the Character string; the Caret '^' becomes only then as Negation allowed, when it is placed at the start (of) the Character string (immediately after the '['). The '$' is evaluated correctly only if it is the last character of the string. '^' for the Line start is implemented, but is not functioning, because after a Found set within a Line still more sought after becomes, and therefore the GREP-Function becomes confused trying to start a new line. Note: The Search using regular Expressions is not trivial and requires a certain amount of practice. It can even be, that certain uses of it will remain beyond your grasp becuase you cannot formulate a search pattern that will yield the desired result. GREP is really not "find all". 5.2. The Match function. This is a familiar MS-DOS function, which in 7UP can take wildcards, preferably '*' and '?'. Take an example where we have a list with Article numbers before itself, and may well need to search out all typical numbers for a certain sample group. e.g.: 99XXX450, where XXX for three variable Digits is placed. You therefore type as Search pattern "99???450". Here gives it now a Specificity, that the search will find "99???450" ONLY if in the Line ONLY those characters are placed. Of course we do not expect these to be the only characters on a line, so We expand the Search pattern by using the Format "*99???450*". The Stars before and after the Numbers stand for any number of any characters. The Wildcards are therefore '?' for one desired Characters and '*' for any number of Characters. When you now want to search forprecisely for '*' or '?', you must then change the Wildcards. You can replace the default wildcards in the appropriate input field of the dialog box. It is important to note that whatever character you use for the wildcard will not be found in the text by that wildcard. You can also search for Text passages at the Beginning of the Line, as well as at the End, when you appropriately restrict the Wildcards. Do you want to search for a number at the beginning of the line? Type in "99???450*". At the End of the line would be "*99???450". Here also you will find the concept easier as you gain experience. The Quotation marks before and after the Examples are naturally not typed in, they serve only the Distinguishing marks within this Documentation. Note concerning GREP and Match: Basically these functions are not useful if you want to automatically replace one character string with another, because the exact length of the search function is not fixed, and replacement in such cases can chaotically deform the text. The wildcard functions should be used only for Search. 5.3. Search. Here the search pattern must exactly be matched. Only with this function is replacing possible. You may search from the current cursor position, from the start of the text, or only within a marked block. You control the Search configuration using the checkoff boxes in the dialog. When a certain combination is not possible, the appropriate checkoff boxes are disabled. They are displayed in light gray and you cannot operate them. 5.4. Replace Hereby becomes the found Text passage replaced by the substitute you have chosen. If you want to delete one or a string of words in the text, type in the word(s) as the Search parameter, and leave the Replace parameter blank. If you want to replace all occurrences without checking thier contexts, check the button 'all'. By checking 'ask before', you instruct the program to stop at each occurrence to ask you if you want to make the replacement. Should you wish to change the replacement at that point, you may do so by changing it in the alert box. 6. The Print menus ----------------- There are two Print menus. One for visually Shaping the Print page with e.g. Header and Footer lines, a for the technical printing Aspects. 6.1 Page layout ---------------- You can configure the following Parameters for the Page size: 1. Line length (same for Header or Footer) 2. left Margin (e.g. Book margin) 3. Page length (12" = 72 Lines, DIN A4 = 70 Lines, 11" = 66 Lines) 4. Top Margin (unprinted) 5. Header (see below) 6. Footer (see below) 7. Bottom Margin (unprinted) Produces: The number of printable Lines (six Lines per 2.54mm). For the Shaping of the Texts you can change Header and Footer lines as well as the Page size in many dimensions. On Header and Footer lines you can insert the following variables using the Function keys: %H = Hour %M = Minute %S = Second %T = Day %M = Month %J = Year (2 places) %W = Weekday (Sunday, Monday, ...) %D = Day in the Year %F = complete Pathname of the current File %F = Name of the current File %P = Page number The Positioning of Headers or Footers (left, right, centered) is chosen with the round Buttons. The Help box displays these Variables, if you should need a reminder. Under "Page format" you can configure the Size (of) the Printer paper. For various tasks different layout settings are needed. You can save the page layouts and load them as needed. The filename may be anything you want, but it should be given the extension "LAY". The default layout file is named "7UP.LAY" and 7UP attempts to load this file at startup. If you want to use a certain layout file as your default, rename that file as "7UP.LAY". The name of the layout file in use is highlighted at the right top of the 'Page Layout' dialog. 6.2 Print ----------- After you have installed the Layout for your Documents, you can now begin with the printing. Set "Numbering", "Pages" and "Options" according to your needs. "Numbering" 1. XXXX Page number offset Use, for instance, when you have a title page that should not be numbered. 2. XXXX First Print page 3. XXXX Last Print page State the range of pages to print. 4. XXX First Text column 5. XXX Last Text column State the Text column, from and to that you want to print. Quite useful in a multicolumn page when you want to print one column as a 'clip'. "Options" used to Configure the Spooler CALCLOCK: 1. PRINT TO FILE... The print output is linked into a file, and the FSB automatically assigns a filename. This function is useful when you want to be able to see what the printed output will look like without wasting paper actually printing it. 2. PRINT IN BACKGROUND 7UP can by using the Desk accessory CALCLOCK print Files in the background while you continue to use the computer. CALCLOCK.ACC must be installed for this to work. See CALCLOCK.DOC. 3. DELETE SPOOL FILE CALCLOCK produces a Temporary file, which after printing may be deleted. 4. XX COPIES(n) XX is the number of copies you want CALCLOCK to print. In "Page format" you can configure the Organization (of) the Entire text. 1. HEADER AND FOOTER AFTER FIRST PAGE When you want the header and/or footer to only appear on the first page, turn this OFF. 2. ALTERNATE PAGE LAYOUT Header and footer loacation (unless centered) will be alternated depending on whether a left or a right page is being printed. 3. TRUNCATE LONG LINES If you want to avoid having the printer 'wrap around' lines that are longer than the permitted line length, (possibly confusing the Layout, you can truncate overlong lines in printing. 4. PRINT ALL PAGES 5. PRINT ONLY EVEN PAGES 6. PRINT ONLY ODD PAGES When you want to print on both sides of the paper, you can print only the odd pages first, then re-feed the reverse side of the pages to print the even pages. 7. EJECT LAST PAGE When you are not printing footer lines, activate this box to send the printer a formfeed command when printing terminates. 8. PAUSE BETWEEN PAGES Wait for an individual sheet feed after each page. You can also quit printing during this wait state if desired. You can abort printing at any time by pressing the ESCAPE [Esc] key. 7. The Desktop icons ------------------- On the Desktop background the following Icons are accessible: 1. maximum of seven Text icons 2. the Trashcan 3. the Printer 4. the Disk drive 5. the Clipboard The Icons can be freely positioned. Moving the Icons functions just as it does on the GEM Desktop. With the Rubberband lasso you can group-select more than one Icon. By holding the SHIFT key while clicking on icons, you can group-select more than one icon. Icons react on Single and Double clicks. By single-clicking you activate the icon(s) for use with menu selections of the "File" menu, e.g. "Information...". Double-clicking an icon opens it. 1. the text icon opens a text window 2. the trashcan opens the FSB for a "Delete" operation 3. the Printer opens the FSB for a "Print File" operation using the spooler 4, the disk drive opens the FSB for an "Open File" operation 5. the Clipboard opens the SCRAP.TXT Clipboard file Dragging a file icon to the printer, disk drive or trashcan, automatically causes the appropriate action to be executed. Dragging a file icon to the Clipboard copies its entire text to the Clipboard. Also you can Expand the function of the Clipboard by Pressing the SHIFT key. You can drag a File icon into a Window, and that file will be merged into the window document at the cursor position exactly as it is with the menu selection "Merge...", assuming that the File has already been saved to disk. Dragging the file to the disk drive will Save the file; to the trashcan will delete it; to the Clipboard will copy it to the Clipboard. You can use the usual wildcards '*' and '?' in making deletions. "*.TXT" erases all files with the extension "TXT", and "*.*" erases ALL files, so be very careful using the wildcards. To operate 7UP under multitasking you must turn off its desktop. These icon operations listed above then are not possible. See Chapter 2.1. 8. The GEM-Window ------------------ All Text is in a completely normal GEM-Window presented. The text window is renamed in accordance with the name chosen for any "Save as..." operation, so any subsequent "Save" reflects the new name. The following information is displayed in the "Info" line at the top of the window: 1. Program name (during 7UP Operation without Desktop) 2. '*' shows that text has been changed since the last Save 3. "P:" = current Page (dependent on Page layout) 4. "L:" = current Line 5. "C:" = current Column 6. "l:" = Length of the Line in which the Cursor is placed 7. Tab:" = number of spaces in the Tabs 8. "W:" = Line wraparound column 9. State of the CAPSLOCK key (CAPS = Caps on; nothing displayed = Caps off) To move quickly among several open windows, use the shortcut '^W'. In the Window menu you can choose your preferred configuration for multiple windows. 8.1. The Dialog boxes -------------------- Use of the dialog boxes is pretty much standard. All of the radio buttons and checkboxes with help of the ALTERNATE key and the underlined letters are accessable by keyboard. Actually you can even click on the text following the radio buttons and checkboxes as they have been made mouse-clickable zones. Aborting an operation can be accomplished using the "UNDO key, and help obtained by pressing the HELP key. These conveniences have become a current standard for ST programs. You can shift the dialog boxes to a more convenient screen position by moving the cursor to the dialog box's "donkey's ear" and dragging the dialog box as you would a Desktop icon. By holding down the SHIFT key as you do this, the dialog box becomes transparent. This is a quick way of checking what is "under" the dialog box. 7UP works flawlessly with LETEMFLY. If you hold down SHIFT when you reopen a dialog box that has been moved, it reopens in the original centered position. 9. The Clipboard ----------------- This is a chapter describing the operation of the Clipboard. The Clipboard occupies its own folder, preferably in the root directory of the boot partition of your hard disk or on the floppy disk in drive A: if you do not use a hard drive. In this folder cut or copied data of any type (in 7UP, text) can and should be recorded for the current program or any other program to use. The folder is shown as "\CLIPBRD". So all Cut and Copy operations divert data into this folder and into its file, "SCRAP.TXT", and all Paste operations draw from this file. Cut and Copy and Paste can of course be done without using the Clipboard, but there are some advantages in using the Clipboard. For instance, by holding down SHIFT as you Cut or Copy, the Cut or Copied block is appended to the already existing \CLIPBRD\SCRAP.TXT file. Subsequent Paste operation wil then insert the entire contents of SCRAP.TXT at the cursor position. If you don't hold down the SHIFT key at the next Cut or Copy, SCRAP.TXT is once again overwritten in the operation and the prior contents is thereby purged. Block Delete operations hold the deleted range in the Clipboard, so you can cancel the deletion with UNDO. The same holds true for line deletion using CONTROL-Y, as long as the cursor remains located in the current line. If no \CLIPBRD folder exists, 7UP will automatically create it and log it into GEM. Atari ST users without hard disks will see a certain loss of speed during Clipboard operations. Like all other application programs, 7UP shows to its best advantage using a hard disk. When the Clipboard is not activated, all Cut or Copied blocks or lines are buffered in RAM and can be reinserted from there. 10. Technical Details ---------------------- For Experts and those who want to become experts. 10.1 7UP is in the Position to take Parameters in three different ways. 1. in the normal way in the basepage 2. according to the so-called EXARG-Method(ARGV=). 3. by 'shell_read()'. It can up to to seven Parameters simultaneous be assigned. When the Desktop lets you, can It so up to to seven Text files simultaneously on the Icons of 7UP pull, and 7UP with them start. 10.2 7UP is able to communicate with the Desk accessory CALCLOCK. CALCLOCK places a built-in Printer spooler that will print ASCII text from a background buffer. The standardized DRI protocols are used. Filename to ACC send: accid=appl_find("CALCLOCK"); /* Program-ID */ msgbuf[0]=100; /* Sendcode */ msgbuf[1]=gl_apid; /* own apid */ msgbuf[2]=-1; msgbuf[3]=strlen(filename); msgbuf[4]=(unsigned int)((long)filename >> 16); msgbuf[5]=(unsigned int)((long)filename & 0xffff); msgbuf[6]=1; /* Number of Copies */ msgbuf[7]=0; /* After Print: 0=not delete, 1=delete */ appl_write(accid,16,msgbuf); The FILENAME must static be. It allows not topical on the Stack produce became be. Dynamic allocated Variables are likewise problematic, because at least one Event must be awaited, before you again "free"ed become. After successful ReceiptCALCLOCK sends the MSG 101 to msgbuf[0]. 10.3 7UP supports (AMC)GDOS*. When GDOS is loaded, only nonproportional GDOS fonts can be used. GDOS is not a part of 7UP. You may obtain GDOS (or AMC-GDOS) from various sources. <Translator's note: The author here goes into a detailed description of how to set up GDOS. Since the time the original DOC was written, Atari has released FONTGDOS, which obsoletes the section. Therefore I have left it out.> Still in 1991 FSMGDOS should appear. It gives us Vector fonts, the quality of whioch should put competitive products in the shade. We can hope that the new FSMGDOS will bring order into the chaos that GDOS now represents, and that all software packages will support it. 7UP will be updated to support FSMGDOS when it becomes available. <Translator's note: We are ever the optomists - here it is 1993 and we await SPEEDO GDOS, which should "solve all our problems".> 10.4 7UP bends no Vectors whatsoever and has therefore also no XBRA-problems. 10.5 7UP has been for Operation on the TT appropriately modified, i.e. fast-LOAD- and TT-Ramflags are appropriately set. 11. The TURBO-C HELP Accessory ------------------------------ 7UP supports the "TURBO-C HELP Accessory". Mark a C-Keyword and operate the HELP-Key. For exact instructions in using TC_HELP.ACC, see the user's manual for that program. TC_HELP.ACC supports the GEM-Clipboard, so you may move the help text or programming info from it into your text as desired. TC_HELP.ACC is not included in the 7UP archive, but may be freely copied and used. You should be able to find it on public bulleting board systems. 12. Trips and Ticks. -------------------- Tabs: When you open a document which has used tabs of other than 3, 5, or 8 spaces, the document may not display the correct appearance. That is because 7UP uses a default of 3 spaces for a tab. To bypass 7UP's default, you may open a new (empty) window, adjust the tabs for that window as needed, then load the fille as a Block. Your tabs will then appear correctly. INF-File: You can write-protect the 7UP.INF file, then any changes made in the 7UP configuration wil not be saved. Printer: If you use a Hewlett-Packard DeskJet 500 printer, you should turn OFF the perforation skip (DIP-switch A8). When printing a block, do so while holding down the SHIFT key to have the printer eject the page after finishing printing. It is generally recommended that you hold the SHIFT key while loading a text in order for 7UP to use the IBM-compatible 'ß'. See Chapter 2, "Open...". If you have a problem with the automatic pagelength, you can set 'hard' page breaks by inserting formfeeds (FF). The formfeed character must be the olnly character on the line. These formfeeds are not reflected in the page numbering in the info line of your text window. 13. Four Word -------------- Here are four Words. 14. Greeting ------------ I wish you much enjoyment in your use of 7UP Michael Thänitz -------------------------------------------------------------------------- *GEM is a Trademark of Digital Research Inc. *Gemini is a Shareware program from Gereon Steffens and Stefan Eissing. *GDOS is a Trademark of Atari Corp. *AMCGDOS is a Program from Arndt Beißner. *Unix is a Trademark of AT&T. *MultiGEM is a Program from PAM-Software. *IBM is a Trademark of International Business Machines Corp. This document translated into English by Mike Valent, April 1993 I assume no liability for any errors in translation